home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 26.zip / BS1 part 26 / Powervisor v1.10b disk2.adf / Aliases next >
Text File  |  1991-09-23  |  8KB  |  305 lines
  1. *--------------------*
  2. * Reference: Aliases * Mon Sep 23 09:47:58 1991
  3. *--------------------*
  4.  
  5.  
  6. ============================== Introduction ==================================
  7.  
  8. This reference file contains all aliases defined in s/PowerVisor-startup
  9. and s/pv/ExtraAliases.
  10.  
  11. =================================== why ======================================
  12.  
  13.    WHY
  14.  
  15.  
  16. Definition : help e\(error)
  17. Defined in : s/PowerVisor-startup
  18.  
  19. This alias gives some additional help for the last error.
  20.  
  21.  
  22. Related commands: help
  23.  
  24. =================================== lfd ======================================
  25.  
  26.    LFD <library name>
  27.  
  28.  
  29. Definition : loadfd [] fd:[]_lib.fd
  30. Defined in : s/PowerVisor-startup
  31.  
  32. This alias loads a ¹fd-file for a library. It is simply a shorthand
  33. notation.
  34.  
  35.  
  36. Example :
  37.  
  38. < lfd exec <enter>
  39.  
  40. instead of
  41.  
  42. < loadfd exec fd:exec_lib.fd <enter>
  43.  
  44.  
  45. Related commands: loadfd
  46.  
  47. =================================== bin ======================================
  48.  
  49.    BIN <number>
  50.  
  51.  
  52. Definition : bin  = {bin8 ([])>>8;bin8 ([]);print \0a}
  53.              bin8 = print \(([])>>7&1)\(([])>>6&1)\(([])>>5&1)\(([])>>4&1)
  54.                     \(([])>>3&1)\(([])>>2&1)\(([])>>1&1)\(([])&1)
  55. Defined in : s/PowerVisor-startup
  56.  
  57. This alias shows the binary representation of the 16 least significant
  58. bits of <number>.
  59.  
  60.  
  61. Example :
  62.  
  63. < bin 1234 <enter>
  64. > 0000010011010010
  65.  
  66. =================================== cmd ======================================
  67.  
  68.    CMD <cli command line>
  69.  
  70.  
  71. Definition : {rc="[]";rx s:pv/cmd}
  72. Defined in : s/PowerVisor-startup
  73.  
  74. You can use this alias to execute Cli commands from within PowerVisor.
  75. The output will appear on the default logical window. This alias uses
  76. a unique temporary file in 'T:'.
  77.  
  78.  
  79. Example :
  80.  
  81. < cmd dir dh0: all <enter>
  82. > ...
  83.  
  84. =================================== asm ======================================
  85.  
  86.    ASM <address>
  87.  
  88. Definition : {rc=[];rx s:pv/assem}
  89. Defined in : s/PowerVisor-startup
  90.  
  91. This alias calls a simple assembler written in ARexx. See s:pv/assem.pv for
  92. more info about the assembler. Stop the assembler with an empty input line.
  93.  
  94. ================================= mstack =====================================
  95.  
  96.    MSTACK <task> <microseconds>
  97.  
  98.  
  99. Definition : {rwin 1;r 5 {home;d getstack()};stack []}
  100. Defined in : s/PowerVisor-startup
  101.  
  102. This alias is equivalent to the 'stack' command. The difference is that
  103. this alias first opens the ³refresh logical window with one visible line and
  104. installs a ²refresh command to display the maximum stack usage two times
  105. per second (5 ¹IntuiTicks).
  106.  
  107.  
  108. Example :
  109.  
  110. < mstack workbench 10000 <enter>
  111.  
  112.  
  113. Related commands: stack refresh
  114.  
  115. Related functions: getstack
  116.  
  117. =================================== at =======================================
  118.  
  119.    AT <command string> <code string> <qualifier string>
  120.  
  121.  
  122. Definition : attach [1] co([2]) qu([3]) e
  123. Defined in : s/PowerVisor-startup
  124.  
  125. This alias ¹attaches a command to a key (makes a macro). The advantage of
  126. this alias is that you can use names for the ¹code and ¹qualifier of the
  127. key instead of numbers.
  128.  
  129. Note that you have to define the 'co' and 'qu' functions in order to
  130. use this alias (this is already done in s/PowerVisor-startup).
  131.  
  132. Note that the 'co' function does not work perfectly in ²AmigaDOS 1.3. Only
  133. use the 'co' function (and thus the 'at' alias) for special keys
  134. ('enter', 'esc', 'up', ...) and not for normal keys ('a', '3', ...).
  135.  
  136. The following code strings are supported :
  137.  
  138.    f1, f2, f3, f4, f5, f6, f7, f8, f9, f10, esc, enter, ret, up, down,
  139.    right, left, del, help, tab, numl, scrl, prtsc, home, end, nup, nleft,
  140.    nright, ndown, pgup, pgdn, ins, ndel
  141.  
  142.    All other strings are interpreted as one char only (you may only use one
  143.    of the above strings if you have AmigaDOS 1.3)
  144.  
  145. The following qualifier strings are supported :
  146.  
  147.    lshift, rshift, ctrl, lalt, ralt, lcmd, rcmd
  148.  
  149.  
  150. Example :
  151.  
  152. < at 'help commands' help ralt <enter>
  153.  
  154. This command attaches the 'help commands' command to the <right-alt>+<help>
  155. key.
  156.  
  157.  
  158. Related commands: attach remattach
  159.  
  160. ================================== opwin =====================================
  161.  
  162.    OPWIN <window name>
  163.  
  164.  
  165. Definition : {-openpw [] 0 0 300 200;-openlw [] [] 80 40}
  166. Defined in : s/PowerVisor-startup
  167.  
  168. This alias opens a ²physical window <window name> with size 300x200
  169. and opens a ²logical window with the same name in this physical window.
  170.  
  171.  
  172. Related commands: openpw openlw
  173.  
  174. ================================== fact ======================================
  175.  
  176.    FACT <number>
  177.  
  178.  
  179. Definition : fact  = disp {_fact []}
  180.              _fact = void if(([])==1,1,{_fact ([])-1}*([]))
  181. Defined in : s/pv/ExtraAliases
  182.  
  183. This alias computes the facultaty of its argument. It is an example of
  184. how to use ²recursive aliases.
  185.  
  186.  
  187. Example :
  188.  
  189. < fact 5 <enter>
  190. > 00000078 , 120
  191.  
  192.  
  193. Related commands: disp void
  194.  
  195. Related functions: if
  196.  
  197. ================================= fdebug =====================================
  198.  
  199.    FDEBUG
  200.  
  201.  
  202. Definition : script db
  203. Defined in : s/PowerVisor-startup
  204.  
  205. This alias installs the ²fullscreen debugger for you. If the debug logical
  206. window is not open it is opened ('dwin' command). The number of instructions
  207. in the disassembly is set to 5 ('prefs debug' command). Some keys are
  208. assigned to commands (<lcmd> is left amiga key) :
  209.  
  210.    <ctrl>+z       ³singlestep one instruction
  211.    <ctrl>+y       singlestep one instruction
  212.    <ctrl>+a       ²set breakpoint after this instruction and execute
  213.    <ctrl>+s       ³skip current instruction
  214.    <ctrl>+r       ²run program until a breakpoint hit occurs
  215.    <ctrl>+x       ³halt running program
  216.    <ctrl>+b       set/reset a temporary breakpoint at the top of the
  217.                   ³debug logical window
  218.    <ctrl>+t       singlestep but ²skip BSR and JSR instructions
  219.    <lcmd>+u       ²trace until ...
  220.    <lcmd>+b       trace until a ³change of programflow occurs (branch, ...)
  221.    <rcmd>+a       set debug window start address ...
  222.    <rcmd>+b       set ²permanent breakpoint ...
  223.  
  224. Note that these keys can differ when you use another ²default keymap (like
  225. 'azerty' or 'qwertz'). Change the 'db' script if you want to use other keys.
  226.  
  227. 'fdebug' redefines itself. After the fullscreen debugger is installed you
  228. can use 'fdebug' to remove the fullscreen debugger. 'fdebug' is a toggle.
  229.  
  230. Note that the 'db' script (located in s/pv) works best when called
  231. from within the alias. Never execute this script directly.
  232.  
  233.  
  234. Related commands: debug trace break
  235.  
  236. ================================= salias =====================================
  237.  
  238.    SALIAS <commandline>
  239.  
  240.  
  241. Definition : {print \({_fl={pv 48 ·Å[]Å}},%s)\0a;v free(_fl);remvar _fl}
  242. Defined in : s/PowerVisor-startup
  243.  
  244. With this alias you can show the commandline how it would look like
  245. after ²alias substitution. This is very useful for ²debugging aliases.
  246. If an alias does not work well you can use this alias to see what
  247. actually gets executed.
  248.  
  249.  
  250. Example :
  251.  
  252. < alias x '[3][2][1] testing []' <enter>
  253. < salias x i r p last <enter>
  254. > pri testing i r p last
  255.  
  256.  
  257. Related commands: print pvcall
  258.  
  259. =================================== cu =======================================
  260.  
  261.    CU [<number of lines>]
  262.  
  263.  
  264. Definition : u lastmem() []
  265. Defined in : s/PowerVisor-startup
  266.  
  267. This alias is equivalent to the 'unasm' command. The only difference is that
  268. you can specify the number of lines to disassemble without having to specify
  269. the starting address.
  270.  
  271.  
  272. Related commands: unasm
  273.  
  274. =================================== cm =======================================
  275.  
  276.    CM [<number of bytes>]
  277.  
  278.  
  279. Definition : m lastmem() []
  280. Defined in : s/PowerVisor-startup
  281.  
  282. This alias is equivalent to the 'memory' command. The only difference is that
  283. you can specify the number of bytes to view without having to specify
  284. the starting address.
  285.  
  286.  
  287. Related commands: memory
  288.  
  289. =================================== vu =======================================
  290.  
  291.    VU [<number of bytes>]
  292.  
  293.  
  294. Definition : view lastmem() []
  295. Defined in : s/PowerVisor-startup
  296.  
  297. This alias is equivalent to the 'view' command. The only difference is that
  298. you can specify the number of bytes to view without having to specify
  299. the starting address.
  300.  
  301.  
  302. Related commands: view
  303.  
  304.  
  305.